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160 PREFACE 


1e1 INTRODUCTION 


The Ohject Code Utilities ere a collection of commands which 
cen be used to create and uedete libreriess, mecdify certain 
asnects of individuel modules», and fist various types of 
information for each module. 


The utilities aceeot as tnput object medules in CBC abject 
text formet V1.4 generated by cress cempilers and ereoss 


assemblers executing on CYBER 170. Thev run as stand-alone 
commands via the SES Processor. 


1.2 APPLICABLE DOCUMENTS 


The fFellowine is a fist of documents thet either ere referred 
to Irn this specifications or are recommencerc to gid in 
understanding and using these utilities, 


SES User's Handbook (6C045725C) 
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2.0 OBJECT _CODE_UTILITY COMMANDS 


The Dbject Cede Utilities use System Control Language (SCL) 
syntax as the parameter interface. In the descriptions that 
Follows, opticnel paremeters are enclosed in hracketss and all 
parameters of type Iname! cen have a maximum tbength of 21 
cheracterss except for paremeters designated as file names 
(NOS File names cannot exceed 7 characters in length). 


If the name of the generated file is the same es ar inout file 
nemes the new File Is gqenarated on a seraterh File and then 
copied over the old file when the generation is comolete,. 


In all ef the commands, the input op¢grameter keywords 
(file $ fibrary and base i beselib) ere set up such thet if ne 
keyword is specifies or if the 'file’ or "hase! keyword is 
specifieds the Input can be a collection of object =moduies 
formetted into a Library, or just 2 flie conteinin¢g cne or 
more object modules. If» howevers the 'librery’ or ‘'haseltirt 
keyword is specifieds tre input must he formatted as a 
Librarys or a diagnostic is issued. The cutput is determined 
by each particular command. 


Most cf the parameters described da net have defautts. when a 
parameter does have a defaults the default velue is documented 
in the oeremeter deserioticn. 


The commands are described in altohabeticeal order. 
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2.1 COM 3 CHANGE OBJECT MODULE 


This command allows the user to alter varicus charecteristies 
of a mwredule in the specified file, 


som librery=<locali_file name> 
module=<name> 
[new neme=<Cname>d] 
Csubstitute=((<name>ds<named) [a (<naemeds<nere>) ]..2)) 
Comit=(<namead[s<neme>jess)] 
Cgate={<nameadls<name>lese)] 
[not . gate= (<name> s<namedlee.)] 
Cerocedure=<name>] 
Ccomment=<string>] 
upon=<local file named 


Jibrery ? tie §$ File $} f 3 
This peremeter specifies the neme of the focal File 
containing the module to be chanaed. The specified 
Fille may or mey not be 2 Tibrarvs but if the keyword 
used is ib! or tlibrary't,s it must te a tlibrary, 
Whether the tuvon' file is @ librery is determined hy 
the format cf this Input file... 


module } mo 2 
This perameter specifies the neme of the module in the 
librery to be changed, 


new name { nn 3 
This parameter srecifies 2 name which reoleces the 
neme of the specified module. 


substitute $ s 3 
This parameter specifies entry point eair{s) whose 
nemes ere to he substituted. The oairs are of the 
form (<old entry point>s<new entry ooint>) where <old 
entry point> is reanleced by <new entry eoairt, 

omit {to 2 
This parameter specifies entry point(s) whose 
defiritions are to be removed from the cuteut medule, 


gate } q 3 
This perarmeter specifies entry ooint(s) that are to he 
qated in the output module. Gated entry coints can be 
entered From any ring within the files cali bracket. 
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not gate ing 3 


This oerameter specifies entry poirntits) for which the 


gated attribute is te be removed, 


precedure $ ora 3 
This perameter specifies the ertry point at which 
execution is to begin (transfer symhol). 


comment § co 3 
This ecerameter specifies the contents of the 
commentary field in the modute header. 


upon =? up 2 
This parameter specifies the name of the local file 
econteinina the new file. Whetrer the ucon file is 4 
library is determined by the format of the Input file. 


Examples: 


SES.COM LIBRARY=LIB1] MODULE=MDDX NEW LUNAMFEMNDY UPON=LIB2 
This command creates a new tlibraryvs ('"LI8Z' which is 
identiecsti to fibrery ‘$'"LI81' excent that the nere of 
'MNDX!' is changed to 'MOaDyY!, 


SES.COM FILET MODX S#((EPTZNEWEPL) »{( EP Z,NEWES?)) UP=FILE? 
This command creates « naw File 'FILE2!' (mey be 
Yibrary) Identical te "'FILEL!' excent that entry point 
name 'NEWEPL!' repieces "EPL* end %YFNEWEP ZS replaces 
TEPQtT, 


SES.-COM LIB1l MN=MODULEX GHENT G=ENT2 NG=ENT32 PRO=ENTS ae 
CC=*CPlL MIGDS REVIEW! UP=LIB2 

This sommand creates 2 new library ‘LI8Z' identical to 
'LIBL® except thet entry points in module MODULEX are 
modified as foltowst ENT] is removed: €NT?2 is set te 
gated; ENT3 is set to not gated; the transfer symbol is 
chenaqed to ENTS; and the commentary fieic is changed es 
showne 


en 7 cane 
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202 DEQM 3 DELETE OBJECT MODULE 


Tris command allows the user to delete a9 module or ranse of 
modules from a specified file. 


deom Llibrary=<local_ fila lneme>d 
module=(<namerd[l..<namedi(s<namedl..<neme>jl...) 
upon=<local_ file named 


fibrary ! tib 3} file { f 3 
This perameter specifies the name of the ftoreli file 
containina the module(s) or mocule subranceis) to he 


cdeleated. The snecified file may or may not he a 
librarys but if the keyworc used is tyibt or 


"ibrary'ts Et must be @ iibrary. Whether the tuocnt 
File is a library is determined by thre format of this 
input file. 


modula §} mo 3 
This perameter specifies the medule(s) or module 


subrange(t{s) to he deleted from thea file. Tf @ 
specified module Is not on the files a fatal error ts 
issuede 


yuEOn | up 3 
This oesrameter sracifies the name of the tocal file 
upen which the remaining modules are written. whether 
the uoon file Is a tibrary is determined by the format 
of thea input file. 


Exemoles: 


SES.~DEQM LIBRARY=LIB1 MODULE=MNDX UPON=ELIR2Z 
This command creates a tibrary LIP2 identical te LI®1 
except that module MODY is deleted. 


SES.DEOM FILESFILE] MO=(MOQDA..MEDBsMODC) UPSFILE? 
This command creates a fiie FILE2 (will be library if 
FILFEF1l is Jibreary) identicel to FILEL except that the 
modules between MODA end MODB inclusive end MCOC are 
deleted. 


0 ee sa 
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DIOM $ DISPLAY OBJECT MODULE 


2e3 DIDM_S_CISPLAY OBIE 


2) 
ey 
i 

Cz 
Fo 
kK 
~ 
ed 


This command allows the user to display informaticr about all 
or pert of the contents of a object file or library. The 
format of the fist file produced is described in «& Iater 
section of this document artitied "LISTING FILES*®, 


diom Llibrary=<local_file name> 
[module=(<neme>dlee<name>lls<namer>lee<ngemedjJj]...)] 
Clisting=<local_file named] 
fon=(<disolay_option>([s<display_cotion> les.) ] 


Jjibrery | Jib | file § fF 3 
This parameter specifies the nare of the local file 
whese contents are to be displayed, The specifiec 
file mey or may not be @ fibraryv, but If the keyword 
usec is "Fib*® or '"librery'ts» it must he © tibrary. 


module } mo t 
This perameter seecifies the medulets) or module 
subrange(s) ehout which information is to te 
displayed. If a subrangea is srecifieds atl modules in 
the subrange are displaved, {mission causes al! 
modules in the file cr library to he dispisyed. 


listing {| list : 
This perameter specifies the tocel file neme of the 
file en which the display Information is te be 
written. Omission ceuses the information to be 
written to the job cutput file. 


This parameter specifies the ftevel of Information to 
be displayed. Oniy the oetions selected are in 
effect. Valid specifications ere: 

time and date module was created 

entry point definitions of tha module 

module header information 

axternal references mace by the moanule 

all information printed by OD» Es: H and X 
(default) 


rx tno 
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Examples: 


SES.~ODI0M LIBRARY=LIAL MODULE MODY LIST=#LISTXY CNeA 
This command lists 211 informatisn ebeut mocule MODX of 
library LIB1 on File LISTX. 


SES.MIOM FILE=FILEX MO=(MODA..MODRs*ODC) IN=(DeH,X) 
This command tists dete and time createds medule hearer 
informations and external references about modules MODA 
to MOOB Inclusive and MNDC of FILEX (mev be flibrary) on 
File DUTPUT (default). 
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204 GDE_1 GENERATE _OBJECT_FILE 


This command allows a user to generate or update an object 
File, Alsos several object files or libreries can be combined 


into one object file. Perameters for this command are 
descrited under 'GOL - Generate Ohject Libreryt which follows 
below, 


25 GOL} GENERATE OBJECT LIBRARY 


This command sllows 9 user to generate or updste a object 
librery. Also» several object files or tlibreries can be 
combined inte ona chject library. 


Description for calling either the 'GOF' or #GOL' commands 
follows below? 


acf 3} gol 
[fFile=(<tocai_file _name>d[s<local_ file _naredj.ee)] 
[combine=(<named(l.<nemedils<tnemed(..Cnamed]]..2)) 
Ladd=(<nemed({..<nemedi(Cs<named[. <name>] j...)]) 
[replace=(<namardleeKname>dl(s<namedieo<name>Jj...)) 
fafter=<name>] 
Lhase=(<locsl file name> s<tocal_ file named]...)3) 
upon=<local_ file name> 
Clisting=<tocal_file name>] 


file | f $ Vibrery $ fib 3 
This perameter specifies the names of the Files fror 
which object modules specified by the following three 
pnerameters ere to he obteined for the new file. The 
specified file(s) may or may not be tlitrary(s)» but if 
the keyword used is "fib! or "library's, they must te 
library(s). 


The next three parameters ('ecomhbine'ts» ‘''‘sdots and 
‘'reniace’) specify medule(s) or module sutfrange(s) to 
be Included on the new file frem the Files specified 
by the 'ffite/librery? parameter. Nonés ones two or 
all three carameters may be specifiad. If none are 
specifieds at! the modules or the files specified ty 
the 'file/library! parameter will be Included on the 


new filee Oniy the first occurrence of dunticete 
modules are included in the new file. As explsined 


helows the particular paremeter(s) used civea the user 
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control over whether the given modules sheculd exist on 
the ‘base’ Jlibraryis). 


combine { ¢e 3 
This parameter specifies modulets) to be inctuded in 
the new File. The soecified module (s) mey or may net 
exist on the 'haset File(s). If they exists they are 
repleced. 


acd 3 . 
This parameter specifies module(s) to be added on the 
new file, If a specified module duplicetes a module 
already on a file specified by the 'hese! parameters a 
fetal error Is Issuede 


replace i rep 3 
This parameter specifies medulets) to he replaced on 
the new filee If a specified redule dees not already 
exist in 2 file specified by the fhase! perameters a 
fetel error is issued. 


after } af } before { he 3 
This perameter specifies a module on a hese File efter 
or before which te position the new modules. Default 
position Is after the tast module on the tast base 
library. 


hase { b } baselib 7? bi 3 

This parameter srecifies a fist of files te he 
iInciuded in the new file. All modules from the hase 
files become oert of the new file excert duplicate 
modutes (the first occurrance of the mecule tekes 
precedence). The specified file(s) may or may not he 
library(s)» but If the keyword used is ‘thi? or 
Thaselib', they must be tibrery(s). 


upon } up 
This parameter specifies the tocal file name cf the 
new file. If the filename specified duplicetes an 
existing local files, the file is genereted end ther 
copled to the specified file. 


listine = bist 3 
This parameter specifias thea neme of the tisting file 
on which the names of the modules on the new fille are 
fisted In the order in which they ccocurs as well as 
the file from which they came. If this perameter is 
not specifieds no “listing” cutout is eroducecd, The 
formet af this file is deserihed in a later section of 
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this document entitied “LISTING FILES", 


The utility requires that there be an input file specified 
either bv the ‘file’ opsreameters or hase! parameter. Py 
utilizing the tadd'»s trenolace's and 'medulet parameters, the 
user can control exactly «hich medcules from the filei{s) 
specified by the "file! parameter he wents te incivde on the 
new Files while the 'after'? and "before! parameters allow him 
to position the new modules. The keyword specified for the 
Tunpan!' perameter controts whether the resulting new file is @ 
library. For. .e more detailed listing of the medules on the 
library» the user can use the DIOQM command, 


Exampies:. 


SESeGOL FILE=FILEX LIST=LISTX ULON=NEwW 
This commend creates an object tibrary NEWLI8 which 
contains all the modules from file FILEX (may be 


library). Disolay information aprrears on the file 
LISTX. 


ES.GOL LIBsINPLIB ADD=MND] REP=MNDZ BL=eBASELIB UPsNEWLIa 
This command creates en object library NEWLI8 identical 
to tibrary BASELIB except that module MOD2 from ttbrary 
INPLIP repiaces MNDNZ end module ODL from INPLIB is 
added at the end, 


SES,GOF BASE=C(FILELsFILEZ»s FILES) UPONENEWFILE LISTING=LIST*X 
This command creates an object fite (not tibrary) 
NEWFILE which is the combination of files FILE], FILE2 
and FILE3. Oniv the first occurrance cf duolicate 
mofyles epoeers on the new file. Displey informeaticnr 
appears on file LISTX,. 


SESs»GNF FILEAsFILEB MO=(MNDA..MODBSMODC) AFTER=MDDKX oe 
PASFSBASEFILE UP=NEWFILE 
This command creates en object file NEWFILE usinoe file 
BASEFILE as a basa. Modules MOLA thru MODR inclusive 
and MODC from files FILEA and FILER (may be Jibraries) 
ere added after module MODX. 
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The following messages ere output et the termination of 
commands. A! errors cause command to abort. 


13061 FILE file name NOT LOCAL 
SEVERITY: Error 
MEANING? Setf expaneator y¥. 


12062 MISSING IDENTIFICATICN RECORD IN FILE file name 
SEVERITY: Error 
MEANING? Data at the beginning of # module does 
not match expected formet. 


13063 UNEXPECTED IDENTIFICATION RECORD IN FILE file lname 
SEVERITY: Error 
MEANINGS Second identification rerord Found 
hefore end of module. 


12004 UNKNOWN OBJECT TexT INFILE file name 
SEVERTTY: Error 
MEANING: Self explanstory. 


12005 FILE file -name IS NOT LIBRARY 
SEVERITY: Error 
MEANING? Source or base file declared as 
library is net one. 


1201¢ MCDULE module ~neme NOT FOUND 
SEVERITY: Error 
MEANING? Self explanatorye 


13011 DUPLICATE MODULE module name PECLARED 
SEVERITY: Error 
MEANING? Module srnecified more than once. 


13012 END OF MODULE RANGE modulelrsmrel .. module-name2 
NOT FOUND 
SEVERITY: Error 
MEANING? Seif exolanatory.e 


131¢€¢ GENERATION OF type file name COMPLETE 
SEVERITY: Informational 
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131¢] 


13102 


13103 


132¢¢ 


13201 


13360 


MEANING? Generate command normal termination 


{type specifies if library). 


MOOQOULE module lname LOCATIGN Tl ADD NOT FOUND 
SEVERITY: Error 
MEANING: Module declared es onposition for new 
modules (before cr after) not found on 
base file(s) for generate commend. 


MODULE module name TT ADD ALREADY EXISTS CN BASF 
filelname | 
SEVERITY: Error 
MEANING: New module specified by MADD! 
parameter of generate commenn is 
already present on 2 bese Jibrery. 


MODULE module_name TC BE REPLACED NOT FOUND 
SEVERITY: Error 
MEANING! New modufle@ seecifiec hy ‘REPLACE! 
paremeter cof generste commend does dot 
exist on any of the base file(s). 


FILE file lname HAS THE SAME NAME AS A SOURCE FILE 
SEVERITY: Error 
MEANING: <A base file has the seme name as #2 
source file. 


MODULES DELETED ON FILE file name 
SEVERITY: Informational | 
MEANING? Delete command normal terminate. 


ALL MODULES DELETED ON FILE file name 
SEVERITY: Warning 
MFANING3 fUPON*® File of this celete command 
contsins no modules hecause they were 
sil celeted. 


MODULES CHANGED ON FILE file lrame 
SEVERITY: Informational 
MEANING Chenge command normel terminate 
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1336] ENTRY POINT entry _coint name TO CHANGE NOT FOUND 
; SEVERITY: Error 
MEANING: Entry point to substitutes orits cates 
or notuidate usine change command not 
Founde This messeae can siso indicate 
that no antry ecoint was found to match 
the new tranfer symbol (PROCEBURE 
parameter). 


1340 MODULES FROM FILE filelname DISPLAYED 


SEVERITY: Informational 
MEANING? Display commend normal terminate. 
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The generate and display commands gererate tistines of the 
fcllowing formats. 


401 GOF/GOL LISTING _ECRMAT 


The Generate Object File Library cemmands produces @n 
output file ('*LIST’ parameter) to show the disrosition of 
medules from the source @nd hase Files in the order they are 
encountered. The format of the fisting ts as follows: 


GENERATE _OBJECT_fileslibrary PAGE xx 
MODULE NAME FILE NAME STATUS 
moculectneme 1 File_neme ADDED 
medule_name_2 . file_name FEPLACED 
module_-name_3 base _nare 

module nere_4 hese _neme DELETED 


In the fistings "file/tibrary" indicates whether ea library 
was generated. The module names shew the modules on the new 
library fexcenot Ff STATUS=DELETED). Filenames indicated the 
source or base File the module came from. Status indicetes 
the following? 


-blank= module copied from base Iibrary 


ARNDED module added from source file 

REPLACE module from source file repleced one from 2 
base Iitbrary 

NELETED module from a base tibrery was deleted since it 


duplicated one from # prevoius tease library. 
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The Display Ohject Module commend produces an output file 
(LIST paremeter) to show the reouested information about the 
specified modules. The format of the erintout resuesting all 
information (noarameter ON=A) Is shown below. 


DISPLAY OF OGBJECT_FII/Iib - File _neme dat/tim PAGE xx 


MODULES mod name CREATED: date/time KIND? modikine 
GENERATOR NAME VERS! genoneme 
COMMENTARY: com text 


ENTRY POINT DEFINITIONS 


ec name ane (2 per line) 
® 

* 

c 


EXTERNAL REFERENCES 


PEPE PEPE PE DE PA PE TE PE Fi A WO 8 HE TE 8 


ext name ene {2 cer tine) 
2 

» 

ad 


In the printouts Ffil/tib indicates whether the File is a 
library. The filename and date/time of the cisciayvy appegsr in 
the pege Peadere For each module: 


rod name name of module being DISPLAYed 

dete/time date and time created 

medikind module kind (MVS» VVSs TOU, MCE8CEGs or P_LCCDE) 

gen name generator name end version 

com text commentary text from identification record 

ep neme name of entry point; If this entry point is 
gateds, U"GATED™ orecedes the name; Multiple 
entry points are allowed, 

ext name name of axternals Multiple externals are 
allowed. 
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